home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / networking / info-service / gopher / Unix / GopherTools / glog / glog33.readme < prev    next >
Encoding:
Text File  |  1993-07-20  |  4.1 KB  |  107 lines
  1. Gopher LOG 3.3  7/20/93
  2.    Andy Wick - awick@csugrad.cs.vt.edu
  3.    bug fixes:  John-David Childs - jdc@selway.umt.edu
  4.  
  5.    * Fixed up main() routine so that: errors on the command line (or -h
  6.    as the first parameter) cause glog to print the help information and
  7.    abort.
  8.    * Fixed PrintHelp() routine so help message is more understandable.
  9.    * changed FILETYPE character from ' ' to 'I' (What about Image?)
  10.    
  11. ============================================================
  12.  
  13. Announcing Gopher LOG 3.2 
  14.    Andy Wick - awick@csugrad.cs.vt.edu
  15.  
  16.    A day before vacation and a bug in glog.  Oh Well.
  17.    John-David Childs jdc@selway.umt.edu pointed out a slight bug
  18.    in my ProcessLine routine dealing with search.  Should
  19.    be fixed now.
  20.  
  21. =============================================================
  22.    Since I am going on vacation for a while, I thought I would
  23. release a minor update.  I have placed glog31.c (ANSI), 
  24. glog31u.c (NON ANSI, Generated using unprotoize).  In boombox's
  25. gopher incoming directory.  Or it is on the csugrad.cs.vt.edu gopher
  26. server (port 70) in Software/Gopher Log Analyzer.
  27.  
  28. Original version by
  29.    Chuck Shotton - cshotton@oac.hsc.uth.tmc.edu
  30.  
  31. 3.1 adds some features of the old glog that got removed by mistake.
  32.    * Supports all known log entries now. (I was missing search, binary,
  33.       and someothers)
  34.    * Can now have a tIme report
  35.    * The report presentation is a little better
  36.    * Can specify a starting and ending month for the whole command
  37.    with -s <num> and -e <num>.  These are the only options that
  38.    are used for the WHOLE command.  The rest are from left
  39.    to right.
  40.  
  41. =============================================================
  42. 3.0 is almost a total rewrite of the original, with old ideas
  43. from the original, and some new ones of my own.  I tried to make it easier
  44. to get the type of reports that I wanted.  About the only thing
  45. missing that 2.3 could do, is printing reports without the hits
  46. field sorted.
  47.  
  48. I have tested 3.0 with purify and can report there are no memory leaks/bugs
  49. what so ever (at least when I use it :).  The program is very memory hungry
  50. though, you need about 1.5 times the size of the log file of memory.  This
  51. is because the log file is completely parsed and stored in memory 
  52. at startup. You can lower that amount if you compile without the DETAIL 
  53. option, see "glog30.c".
  54.  
  55. How to use:
  56.  glog30 -h will display the options :).  But as a short example.  
  57.  
  58.  How to create a [H]ost report, a [D]ata report with detail of [H]osts and
  59.  width of 132, and a plot of [T]ypes with basename of "test".  The log file
  60.  is called gopher.log.  Don't forget, reports always go to stdout.
  61.  
  62.  % glog30 -H -w 132 -DH -f test -pT < gopher.log | more
  63.  
  64. Tested on:
  65.  gcc 2.3.3 was used on all platforms.
  66.  Amiga DOS (main development), SunOS 4.1.3 (purify 2.0.3), Ultrix 4.2A
  67.  
  68. New Features:
  69.  * The command line is parsed as the reports/plots are generated, so that
  70.    it is possible to change options for each separately.  But options
  71.    are NOT reset for each new one.
  72.  
  73.  * It now can produce reports on the [D]ata, [H]osts, day of the [W]eek,
  74.    data [T]ypes, and [M]onth/date sorted (ie. sorted by date).
  75.  
  76.  * It can now produce detail reports on any thing you can produce a normal
  77.    a report for.  Yes, you can even produce a host detail report of a 
  78.    hosts report. (But it doesn't do you much good :)
  79.  
  80.  * Change the width of the reports.
  81.  
  82.  * You can specify the filename for plots, it defaults to gopher. (The 
  83.    program appends a .dat, and and .run to the name)
  84.  
  85.  * You can request as many plots as you want. (But remember to change the
  86.    filename or you will overwrite the last plot)
  87.    
  88.  * The program is now a lot easier to add new types of reports to, you
  89.    only need to add 3 short routines, a variable, and edit 2 functions.
  90.    (Well, maybe it is simple for me. :)
  91.  
  92. TODO:
  93.  * Fix up plots some more: add histograms, and more options.
  94.  
  95.  * option for how detail works (which way should it work?)
  96.  
  97.  * Someone will probably want to have the hits field unsorted, and I will
  98.    need to hack a way to do that.
  99.  
  100.  * Make it so reports can go to files.
  101.  
  102.  * Make some documentation
  103.  
  104.  * Improve error checking
  105.  
  106. If anyone has any ideas or suggestions please send them to me.
  107.